DEFINITIONS 
This card describes both the 1993 and the 1988 
versions of ksh. Information about just the 1993 
version is in blue. Information about just the 1988 
version is in red. Information that applies to both 
versions is in black. 


Several type faces are used to clarify the meaning: 

« Serifa Bold is used for computer input. 

© Serifa Italic is used to indicate user input and for 
syntactic placeholders, such as variable or cmd. 

|¢ Serifa Roman is used for explanatory text. 


blank — separator between words. Blanks consist of one 
or more spaces and/or tab characters. In addition, 
words are terminated by any of the following 
characters: 

; & ()1<> space tab newline 


(semaael —asenes of words. 


list — one or more pipelines. Can be separated by ;, &, 
&&, ll and optionally be terminated by ;, &, or !&. 


In-an integer. 
name — a variable, alias, function or command name. 


|keyword - a reserved word in the ksh language. 
\Keywords are special only after a ; or newline, after 
janother keyword, and in certain other contexts 


|pat —a ksh pattern. See Patterns. 


pipeline — a command or multiple commands connected 
by a pipe (1). 
|string — a collection of characters treated as a unit. 


substitution — the process of replacing parts of the 
command line with different text, e.g., replacing a 
jvariable with its value. ksh performs many 
|substitutions. This card lists them in the order they are 
\performed. 


word — a generic argument; a word. Quoting may be 
necessary if it contains special characters. 


—_____ COMMAND LINE ARGUMENTS___ 


$ ksh [options] [args] 

- ends option processing 

-—c cmd execute cmd (default reads command 
from file named in first entry of args via 
path search) 

-D print all double quoted strings that are 
preceded by a S. Such strings are subject 
to translation in the current locale. 

-i set interactive mode 


-1 filename generate a cross-reference database for 

| finding variable and command definitions 
and references; may not be compiled in 

-r set restricted mode 

-8 read commands from stdin (default) 


STARTUP FILES 
Login shells run commands in /etc/profile and then 
SHOME/.profile if they exist. Next, interactive (all) 
shells do variable, command, and _ arithmetic 
substitution on the value of SENV, and if the result 
names an existing file, that file is executed. The errexit 
joption is ignored for the startup files. 
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CONTROL COMMANDS 


CONDITIONAL EXPRESSIONS 


ALIASING____ aera 


1 pipeline 
execute pipeline. If exit status was non-zero, exit 
zero. If exit status was zero, exit 1. 
case word in [[(]pat1[Ipat2)...) list ;;]... esac 
execute list associated with pat that matches word 
field splitting is not done for word 
pat is a ksh pattem (see Patterns) 
lis used to indicate an OR condition 
use leading ( if case inside $( ); 
otherwise quote unbalanced ) inside S( ) 
use ;& instead of ;; to execute next list 
|for name [in words] ; do list ; done 
sequentially assign each word to name and 
execute list; if in words is 
missing use positional parameters 
for (([expr1]; [expr2]; [expr3])) ; do list ; done 
evaluate expr1 once; evaluate expr2, as 
long as it is non-zero, execute list and 
then evaluate expr3 
any missing expr is treated as 1 
function funct { list; } 
define function funct, body is list, ksh semantics 
funct () { list; } 
define function funct, body is list 
System V and POSIX syntax 
(see Functions) 
ksh93: POSIX semantics, ksh88: ksh semantics 
if list? ; then Jist2 [; elif list3 ; then list4]...[; else list5] ; fi 
if executing /ist? returns successful exit 
status, execute list2 else ... 
select name [in words] ; do list; done 
print a menu of words, prompt with $PS3 and read 
a line from stdin, saving it in SREPLY 
if the line is the number of one of the words, 
set name to it, otherwise set name to null 
execute list 
if in words is missing use positional parameters 
empty lines cause the menu to be printed again 
if REPLY set to "", reprint menu (ksh88d and later) 
time [pipeline | 
execute pipeline; print elapsed, system and 
user times on stderr 
if pipeline is missing print user and system times 
for current shell and completed children 
on stderr 
until list 1 ; do list2 ; done 
like while but negate termination test 
while list 1 ; do list2; done 
execute Jist 1; if last command in Jist1 hada 
successful exit status, execute list2 
followed by list 1; repeat until last 
command in Jist1 returns an unsuccessful 
exit status 
((...)) 
arithmetic evaluation, like let "..." 
[[expression]] 
evaluate expression, return successful exit status 
if true, unsuccessful if false 
(see Conditional Expressions for details) 
(list) 
execute Jist in a sub-shell 
{list ;} 
list is executed in current shell only 


Used with the [[...]] compound command, which does 
not do pattern expansion or word splitting. 


string true if string is not null 

—a file true if file exists (—e is preferred) 
-b file true if file is a block device 

-c file true if file is a character device 
-C file true if file is a contiguous file 

-d file true if file is a directory 

—e file true if file exists (ksh88g and later) 
-f file true if file is a regular file 

-g file true if file has setgid bit set 

-G file true if file group is effective gid 
-k file true if file has sticky bit set 

-L file true if file is a symbolic link 

—n string true if string has non-zero length 


—o option true if option is on 

-O file true if file owner is effective uid 
-p file true if file is a fifo (named pipe) 
-rx file true if file is readable 

-s file true if file has non-zero size 

-S file true if file is a socket 

-t filedes true if filedes is a terminal 

-u file true if file has setuid bit set 
-w file true if file is writable 

-x file true if file is executable 

-z string true if string has zero length 


file1 —nt file2 true if file] is newer than file2 

or file2 does not exist 
filel -ot file2 true if file] is older than file2 

_ or file2 does not exist 

file1 -ef file2 true if file1 and file2 are the same file 
string = pattem 

true if string matches pattern 

quote any part of pattern to treat 

it as a string; obsolete in ksh93 

string == pattern 

same as = (preferred in ksh93) 
string != pattern 

true if string does not match pattern 

quote any part of pattern to treat 

it as a string 

string! < string2 

true if string! is before string2 
string! > string2 

true if string/ is after string2 
exp! —eq exp2 true if exp1 equals exp2 
exp! —ne exp2 true if exp1 does not equal exp2 
expi-ltexp2 true if exp] is less than exp2 
exp1 -—gt exp2 true if exp1 is greater than exp2 
exp1—le exp2 tmue if exp] is less than or equal to exp2 
exp1 —ge exp2 true if exp? is greater than or 

equal to exp2 
(expression) true if expression is true, for grouping 
1 expression true if expression is false 
exp1 && exp2 true if exp? AND exp2 are true 
expl|llexp2 __ true if exp! OR exp2is true 


If file is /dev/fd/n, file descriptor n is checked. 


Both && and Il are short circuit. Operands of 


comparison operators undergo arithmetic evaluation. 


The arithmetic comparison operators —eq, —ne, —It, —gt, 


-le, and -ge are considered obsolete in ksh93. 
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alias name=value ... | 
| 


Aliases are expanded when a command is read, not} 
when executed. Alias names can contain any non-| 
special character, not just alphanumerics. Alias | 
expansion is done on the first word of a command. If 
the last character of the replacement text is a blank, 
then the next word in the command line is checked for | 
alias expansion. Tracked aliases automatically set the | 
name of a command to the full pathname of the! 
command. Aliases cannot be used to redefine shell! 
keywords. 


PRE-DEFINED ALIASES._ 
alias autoload='typeset — fu’ 
alias command='command ' 
alias false='let 0’ 
alias fc=hist | 
alias float='typeset -E' | 
alias functions='typeset -f' | 
alias hash=’alias -t -—' 
alias hash="'alias -t’ 
alias history="hist -1' 
alias history='fc -1' 
alias integer='typeset —i' 
alias nameref='typeset —n' | 
alias nohup='nohup ' 
alias r="hist -s' 
alias r='fc -e -’ 
alias redirect='command exec' 
alias stop="kill -s STOP’ 
alias times="{ {time;}2>8&1;}' | 
alias true="':' 
alias type='whence -v' 
l 


ee TIEDE SUBSTITUTION = 
substitute SHOME | 
“user substitute user's home directory | 
+ substitute SPWD 
- substitute SOLDPWD | 


Tilde substitution happens after alias expansion. It is 
done for words that begin with ~ and for variable 
jassignment. 


In variable assignments, also done after a: in the value. | 
In ksh93, tilde substitution is done as part of word 
expansion. This means for ${name op word}, word will be 
checked for tilde substitution. 


COMMAND SUBSTITUTION 


S(command) new form | 
‘command’ old form (deprecated) | 


Run command, substitute the results as arguments. 
Trailing newlines are removed. Characters in SIFS 
separate words (see Field Splitting). New form is 
preferred for simpler quoting rules. 


$((expression)) arithmetic substitution 


The expression is evaluated, and the result is used as an 
argument to the current command. 


For bug reports, please write, or send electronic mail to 
bugs@ssc.com. 5 


ARITHMETIC EVALUATION 
Arithmetic evaluation is done with the let built-in 
|command, the ((...)) command, and the S((...)) notation 
for producing the result of an expression. 


All arithmetic is done using double floating point 
/numbers (long integers). Use typeset -i to get integer 
jvariables, typeset —E or —F for floating point variables. 
Assigning a floating point value to an integer causes 
|truncation of the fractional part. Integer constants look 
{like [base#]n where base is a decimal number between 
jtwo and 64 (36), and n is in that base. The digits are 
\0-9, a-z, A-Z, @, and _. Floating point constants are as 
jin ANSI C. 

| 

‘The following operators based on C, with the same 
\precedence and associativity, are available. 

| 


|4+ -- auto-increment, auto-decrement 
both prefix and postfix 

\+ unary +, no effect 

yo logical, bitwise, arithmetic negation 

ft fh 4 multiply, divide, modulus 

‘+ - addition, subtraction 

<< >> left shift, ight shift 

<< comparisons 

jz= I= equals, not equals 

& bitwise AND 

\" bitwise XOR 

| bitwise OR 

(8c& logical AND, short circuit 

i logical OR, short circuit 

|?: in-line conditional 

= ==3 (S/E 535 CE (BS KS SS 

| assignment operators 

6 sequential expression evaluation 


Inside let, ((...)), and $((...)), variable names do not need 
‘a § to get their values. 


|The following mathematical functions are available. 


| They are called using C function call syntax. 


‘abs absolute value int integer part 

jacos arccosine log natural logarithm 

asin arcsine sin sine 

atan arc tangent sinh hyperbolic sine 

|cos cosine sqrt square root 

‘cosh hyperboliccosine tan tangent 

jexP exponential,e**x tanh hyperbolic tangent 
PROCESS SUBSTITUTION 


\cmd <(list1) >(list2) 


‘Runs listi and list2 asynchronously, with stdin and 
‘stdout respectively connected via pipes to files in 
\/dev/fd. These file names are given as arguments to 
‘cmd, which expects to read its first argument and write 
its second. This only works if you have /dev/fd. 


a BRACEIEXPANSION= == 


It is possible to compile ksh to do brace expansion like 
‘csh does. If it is available, the following will work: 


$ echo a{1,2,3)b 
alb a2b a3b 


jon some systems, though, you won't have it. 
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VARIABLE NAMES _ 


PRE-DEFINED VARIABLES 


Variable names are made up of letters, digits, 
underscores, and periods. They may not start with a 
digit. There is no limit on the length of a variable name, 
and the case of letters is significant. To create a 
variable with a period in the middle of its name, a 
jvariable whose name consists of everything up to the 
|period must already exist. For example, now.hour is 
legal, but now must already exist. Variables whose 
jnames contain periods cannot be exported. 


| Variable names that begin with .sh are reserved for use 
|by ksh. 


Indirect references to variables are possible, using 
|typeset -n. Such a variable is called a nameref. A 
|nameref variable cannot have periods in its name. Here 


NE 
is an example. 
| 


| $ old=123 

$ typeset —n new=old 
$ echo Snew 

123 


| This can also be used to change the original variable. 


$ new=345 
$ echo Sold 
345 


|This feature is particularly useful for passing variable 
names to functions. 


| 


aa ARRAYS 

Arrays in ksh can contain at least 512 elements. Many 
limplementations allow larger limits, and 1024 is 
common. Array indices start at 0 and go up to one less 
jthan the maximum, for example, 511 or 1023. The 
|maximum is increased to 4095 in ksh93. Array 
subscripts can be arithmetic expressions. 


In ksh93, associative arrays are created with typeset 
-A. When using associative arrays, subscripts are 
strings instead of numbers. 

L 


VARIABLE ASSIGNMENT _ 
Assignments to integer and float variables undergo 
arithmetic evaluation. Variable assignments have one 
of the following forms. 


name=word set name to word 
namel[index] = word 
set element index of array name to word 
[ and ] act like double quotes 
name =( word...) 
set indexed array name to words 
name =([word]=word ...) 
set indices of associative array name 
to words 
name =( assignment ...) 
nested variable assignment 
name =( typedef [options] assignment ...) 
nested variable assignment 
separate multiple assignments by ; 


Indexed array assignment can also be done with set. 


set +A name arg... 
set indexed array name to given values 
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Sn use positional parameter n, n <=9 
S{n} use positional parameter n 

s* all positional parameters 

$@ all positional parameters 

LEO equivalent to "$1$2..." 

"Se" equivalent to "$1" "$2"... 

S# number of positional parameters 
S{#*} number of positional parameters 
S{#@} number of positional parameters 
s- options to shell or by set 

$? value returned by last command 

Ss process number of current shell 

$! process number of last background cmd 
S$ value of last positional argument in 


last command 
${.sh.edchar} character(s) entered when processing a 
KEYBD trap; changing it replaces 
the character(s) that caused the trap 
position of cursor in most recent 
KEYBD trap 
${.sh.edmode} equal to (esq when processing a KEYBD 
trap in vi mode, null otherwise 
${.sh.edtext} characters in the input buffer in a 
KEYED trap 
name of the variable running a 
discipline function 


S{.sh.edcol} 


${.sh.name} 


|${.sh.subscript} 


subscript of the variable running a 

discipline function 

value of the variable inside the set 

and get discipline functions 

S{.sh.version} identifies the version of the shell 

SCDPATH search path for cd command 

SCOLUMNS length of window for editing and select 
menus 


S{.sh.value} 


SEDITOR command line editor if SVISUAL unset 

ISENV in interactive (all) shells, value is 
variable, command, and arithmetic 
substituted for path of start-up file 

|SFCEDIT obsolete default editor for hist command 
default editor for the fe command 

SFIGNORE pattern giving the set of filenames to 
ignore when doing pattern matching 

SFPATH search path for functions defined with 
typeset -—u 

SHISTCMD history number of current command 

SHISTEDIT default editor for hist command; if set, 
overrides SFCEDIT 

SHISTFILE where command history is stored 

SHISTSIZE number of previous commands to keep 
available 

SHOME home directory for cd command 

SIFS field separators (space, tab, newline) 

SLANG name of current locale 

SLC_ALL current locale; overrides SLANG and 


other SLC_ variables 
$LC_COLLATE 

current locale for character collation 
S$LC_CTYPE current locale for character class 

functions (see Patterns) 
S$LC_NUMERIC 

current locale for decimal point 


SLINES 


controls vertical size of select menus 
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SLINENO line number of line being executed in 
script or function 

SMAIL name of a mail file, if any 

SMAILCHECK 


check for mail every n seconds 
(600 default) 

SMAILPATH filenames to check for new mail; uses: 
separator; filename may be followed 
by ?message; $_ in message is matched 
mail file name 


SOLDPWD previous working directory 

SOPTARG value of last argument processed by 
getopts 

SOPTIND index of last argument processed by 
getopts 

SPATH command and function search path 

SPPID process id of shell's parent 

SPS1 primary prompt string ($) 

SPS2 secondary prompt string (>) 

SPS3 select command prompt string (#7?) 

SPS4 debug prompt string (+) 

SPWD current working directory 

SRANDOM set each time it’s referenced, 0 — 32767 

SREPLY set by select and read commands 

SSECONDS number of seconds since shell invocation 

SSHELL name of this shell | 

STMOUT number of seconds to wait idly before 
terminating; for prompt and select 

SVISUAL choice of command line editor 


VARIABLE SUBSTITUTION 
Sname reference to shell variable name 
S{name} use braces to delimit shell variable name 

required if name contains periods 
$ {name - word} 
use variable name if set, else use word 

|$ {name = word} 
as above but also set name to word 
${name? word} 
use name if set, otherwise print word and 
exit (interactive shells do not exit) 
$ {name + word} 
use word if name set, otherwise use 
nothing 
|${name[n]} element n in array name 
S{name[word]} element word in associative array name 
S{#name} length of shell variable name 
S{#name[*]} number of elements in array name 
S{#name[@]} number of elements in array name 
${Iname} name of variable referenced by name; 
same as name unless name is a nameref 
| ${Iname[subscript] } 
value of actual subscript for array name 
S{Iname[*]} list of subscripts in array name 
S{Iname[@]} list of subscripts in array name; 
inside double quotes expand to 
separate words 
| S{lprefix* } 
| S{lprefix@ } list of variables whose names begin 
with prefix 
${name#pat} remove shortest leading substring 
of name that matches pat 
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-___PRE-DEFINED VARIABLES (continued) __ 


| 


VARIABLE SUBSTITUTION (continued) 


= FIELD SPLITTING 


CO-PROCESS __ 


BUILT-IN COMMANDS (continued 


\S{name##pat} remove longest leading substring 
of name that matches pat 
\S{name%pat} remove shortest trailing substring 
of name that matches pat 
\S{name% %pat} 
remove longest trailing substring 
of name that matches pat 
${name:start} 
S{name:start:length} 
length characters of name starting at 
start (counting from 0); use rest of 
value if no Jength. If name is * or @ 
or an array indexed by * or @, start 
and Jength indicate the array index and 
| count of elements. start and /ength can 
| be arithmetic expressions. 
|S{name/pattem/string} 
| value of name with first match of pattern 
| replaced with string 
|${name/pattern} 
| value of name with first match of pattern 
deleted 
|${name//pattem/string} 
value of name with every match of pattern 
| replaced with string 
${name/#pattern/string} 
| value of name with match of pattern 
replaced with string; match must occur 
at beginning 
|S{name/%pattern/string} 
value of name with match of pattern 
replaced with string; match must occur 
at end 


| 

|Note: for -, =, ?, and +, using name: instead of name 
|tests whether name is set and non-NULL; using name 
jtests only whether name is set, 


|For #, ##,%, %%,/,//, /#, and /%, when name is * or @ 
or an array indexed by * or @, the substring or 
|substitution operation is applied to each element. The 
replacement text can use the \n notation (see Patterns). 


ts ______ QUOTING 
\c quote single character c 
‘apo old-style command substitution 


aon 


text treated as a single argument, double 
quotes removed; variable, command and 
arithmetic substitutions performed; 

use \ to quote §, \, ‘, and" 

like "...", but locale translation done 
text treated as a single argument, single 
quotes removed; text between quotes 

| left alone, cannot include ' 

ise text treated as a single argument, $ and 
single quotes removed; no substitutions 
performed; ANSI C and additional 
escape sequences processed: 


Quoted text becomes one word. Otherwise, words are 
separated by occurrences of any character in SIFS. 
Multiple whitespace characters do not delimit empty 
words, while multiple printable characters do. 
Doubling a whitespace character in SIFS makes that 
character also delimit separate, empty words. 


A co-process can be started in the background, with its 
stdin and stdout connected to the foreground ksh 
script via pipes. I/O to and from the co-process is done 
via the built-in commands read —p and print —p. This 
can be used for driving “back-end” programs like 
database engines. 


PATTERNS 


1? match single character in filename 
lie match 0 or more characters in filename 
[chars] match any of chars 

(pair separated by a - matches a range) 
[!chars] match any except chars 
?(pat-list) optionally match any of the patterns 
* (pat-list) match 0 or more of any of the patterns 


match 1 or more of any of the patterns 
@(pat-list) match exactly 1 of any of the patterns 
I(pat-list) match anything but any of the patterns 
\n text matched by n'th sub-pattern in (...) 


+(pat-list) 


|pat-list is a list of one or more patterns separated by |. 
All the patterns must match if & is used instead of |. & 
has higher precedence than |. 


The POSIX [[=c=]] and [[.c.]] notations for same-weight 
characters and collating elements are accepted. The 
notation [[:class:]] defines characters classes: 


alnum alphanumeric lower lower-case 
alpha alphabetic print printable 
blank space or tab punct punctuation 
cntrl control space whitespace 
digit decimal upper upper-case 
graph non-spaces xdigit hexadecimal 
When expanding filenames, . and .. are ignored, 


filenames matching the pattern in SFIGNORE are also 
ignored, and a leading . must be supplied in the pattern 
to match filenames that begin with. . 


INPUT/OUTPUT ___ 
Redirections are done left to right, after pipes are set 
up. Default file descriptors are stdin and stdout. File 
descriptors above 2 are marked close-on-exec. 


[n]<file use file for input 

(n]>file use file for output 

[n]>I file like >, but overrides noclobber 
[n]>>file like > but append to file if it exists 
[n]<>file open file for read/write (default: fd0) 
[n]<&m duplicate input file descriptor from m 
(n]>&m duplicate output file descriptor from m 
[n]<&m- move input file descriptor m 

[n]>&m—- move output file descriptor m 

(n)<&- close input file descriptor 

[n]>&—- close output file descriptor 

[n]<<word input comes from shell script, treat line 


with word as EOF on input; if any of 
word is quoted, no additional processing is done 
on input by the shell. Otherwise: 


| 
\a alert (bell) \ddd__ octal value ddd * do variable, command, arithmetic substitutions 
\b backspace \xhh hex value hh * ignore escaped newlines 
\f form feed \ single quote * use \ to quote \, S, ’, and first character of word 
\n newline a double quote [n]}<<-word as above with leading tabs ignored 
\r  cartiagereturn \\ backslash [n]<&p move input from co-process 
| \v vertical tab \E escape, not in ANSI C [n]>&p move output from co-process 
10 
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| 
| 


NETWORK CONNECTIONS 

|Starting with ksh88e, the exec built-in command can be 
used to open network connections, by attaching file 
descriptors to special names of the form 
/dev/tcp/host/port and /dev/udp/host/port. This feature 
is available only on systems with TCP/IP networking. 


_EXECUTION ORDER _— 
Before a command is actually executed, all 
substitutions and I/O redirections are performed. 


In ksh93, the command search order is special built-in 
commands first, shell functions second, non-special 
|built-ins third, and then external commands, which are 
found by searching the directories listed in SPATH. 


In ksh88, the command search order is all built-in 
commands first, shell functions second, and then 
external commands, which are found by searching the 
directories listed in SPATH 


The special built-ins are: ., :, alias, break, continue, 
eval, exec, exit, export, login, newgrp, readonly, 
return, set, shift, trap, typeset, unalias, and unset. 


BUILT-IN COMMANDS 
These commands are executed directly by the shell 
Almost all accept -? to print a usage message, and —- 
to mark the end of options. 


. file 
read and execute commands from file 
if arguments, save and restore positional params 
if file is a function name declared with function, 
execute it using POSIX semantics 
null command; returns 0 exit status 
[ see test 


| 
jalias [-ptx] [name[=value]] 
| create an alias; with no arguments, print all aliases 


-p print alias before each alias 
-t set or print a tracked alias 
-x obsolete: has no effect 
set or print an exported alias 
bg [jobid] 
put jobid in the background 
break [n] 


exit from enclosing for, while, until or select loop 
ifn supplied, exit from n'th enclosing loop 

builtin [-ds] [-f file] [ name ...] 
with no arguments, print all built-in commands 


-d delete built-in name 
-s only print special built-ins 
-f load new built-ins from shared library file 


if name contains /, the new built-in is found only 
if a path search matches the name 
if name does not contain /, the new built-in is 


always found as a built-in command 
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ed [-LP] [dir] 
change current directory to dir (SHOME default) | 
directory path search using value of SCDPATH 
-L use logical path for cd .., SPWD (default) | 
-P use physical path for cd .., SPWD | 
if both given, the last one on the command line wins 
cd [-LP] —- | 
change current directory to SOLDPWD | 
cd [-LP] old new | 
substitute new for old in current directory; | 
change to result; obsolete in ksh93 | 
command [-pvV] name [arg ...] | 
without —v or -V, execute name with arguments arg 


-p use a default search path, not SPATH 
-v behave like whence | 
-V behave like whence -—v 


continue [n] 
do next iteration of enclosing for, while, until 
or select loop 
if n supplied, iterate n'th enclosing loop | 
disown [job ...] 
when a login shell terminates, do not senda 
SIGHUP to job, or to all active jobs if none listed 
echo [words] 
echo words; expands \-escapes on some systems 
| (print and printf are more portable) 
leval [words] 
evaluate words and execute result 
jexec [-c] [-a name] [words] 
execute words in place of shell 
if redirections only, change shell's open files 


-c clear the environment first 
-a use name for argv[0] 
exit [n] 


exit with return value n; use $? if non 
export [-p] [names] 
with no arguments, print names and values of 
exported variables 
-p print export before each variable 
export names to environment of commands 
each name can be an assignment, name=val 
false 
do nothing, exit 1 
fc [-e editor][-nlr][first [lasc]] 
print a range of commands from first to last 
from last SHISTSIZE commands 
-e run editor if supplied, if not, run 
SFCEDIT (default /bin/ed) on 
commands; execute result(s) 


-l list on standard output instead of editing 
-n don't print line numbers 
-r reverse order of commands 


fe -e — [old=new] [command] 

substitute new for old in command (or last command 
if no command) and execute the result 

fg [jobid] 

put jobid in the foreground 

getconf [name [pathname]] 

print configuration parameters for name and 
pathname; parameters are defined by POSIX 
getopts optstring name [arg ...] 


parse parameters and options 


nee ee = = — J 
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______ BUILT-IN COMMANDS (continued) —___, 


hist [-e editor][-n1r][first [/ast]] 

print a range of commands from first to last 

from last SHISTSIZE commands 

-e mun editor if supplied, if not, run 
S${HISTEDIT:-SFCEDIT} (default /bin/ed) 
on commands; execute result(s) if file 
with commands was updated 


-l list on standard output instead of editing 
—n don't print line numbers 
—r reverse order of commands 


hist -s [old=new] [commana] 

substitute new for old in command (or last command 
if no command) and execute the result 

jobs [-Inp] [jobid ...] 

list information about jobs 


-l also list process id 
| —n only list stopped or exited jobs 
-p only list process groups 


‘kill [—sig] jobid ... (ksh93: obsolete) 
kill [—s signame] [—n signum] jobid ... 
send SIGTERM or given signal to named jobids 
signals are names listed in /usr/include/signal.h 
without the prefix “SIG” 
stopped jobs get a SIGCONT first if sig is 
either SIGTERM or SIGHUP 
[kill -1 [sigs ...] 
list signal names and/or numbers 
let arg... 
evaluate each arg as an arithmetic expression; 
exit 0 if last expression was non-zero, 1 otherwise 
mewgrp [words] 
same as exec newgrp words 
print [-nprRsu[n]] [-f format] [arg ...] 


if no flags, or just — or —-, act like echo 
(however, the single — is obsolete) 
-f print as if by printf command 
ignore —n, —r, and —R options 
—n don't add final newline 
-p print to stdin of co-process 
=—Y ignore echo escape conventions 
-R like —-r, also ignore other args except -n 
| -8 print to history file 
-u print to file descriptor n (fd1 default) 


printf format [arg ...] 
print output like ANSI C printf, with extensions 


%b expand escape sequences in strings 

%d . plus output base can follow precision 

%P print egrep-style extended regular 
expression as a ksh pattern 

aq print quoted string that can be reread 


arithmetic evaluation is done for numeric formats 
format conversions are reused as needed 


pwd [-LP] 
print working directory name; last option wins 
-L print logical path (default) 
-P print physical path 
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BUILT-IN COMMANDS (continued) —___ 


Goad [-Aprsul[n]] [-d delim] [-t umeout] 
[name?prompt] [names ...] 
read stdin and assign to names; SIFS splits input 
? in first name uses rest of name as prompt to stderr 
SREPLY is set if no name given 
exit 0 unless end-of-file encountered or a timeout 


occurs 

-A read words into indexed array name 

-d read to delim instead of newline 

-p read from stdout of co-process 

=r \ at end of line does not do line 
continuation 

-s save input in history file 

-t wait timeout seconds when reading from 
a terminal or pipe 

-u read from file descriptor n (fdO default) 


readonly [-p] [name=value ...] 
mark names read-only; print list if no names 
-p print readonly before each variable 
return [n] 
exit function with return value n 
with no n, return status of last command; if not in 
function or in . script, like exit 
set [— options] [-o option] [words] 
set flags and options (see Options To set) 
words set positional parameters 
set [+options] [+0 option] [words] 
unset flags and options 
shift [n] 
rename positional parameters; $n+1=$1 ... 
n defaults to 1; n can be an arithmetic expression 
sleep seconds 
stop execution for given number of whole or 
fractional seconds 
test 
evaluate conditional expressions 
(see Options To test and Conditional Expressions) 
times 
print accumulated process times 
trap [-p] [word] [sigs] 
execute word if signal in sigs received 
sigs are numbers or signal names without “SIG” 
with no word or sigs, print traps 


-p print traps with quoting 
with no word, reset sigs to entry defaults 
word is "—", reset sigs to entry defaults 


word is null string, ignore sigs 
sigs is 0 or EXIT, execute word on exit from shell 
sigs is DEBUG, min word for every command 
sigs is ERR, run word after every command with 
non-zero exit status 
sigs is KEYBD, run word when a key is read 
in emacs, gmacs, or vi mode 
true 
do nothing, exit 0 
typeset -f[tux] [name ...] 
each name is a function 
the only other options with —f are: 


-t turn on execution tracing 

-u function is undefined, use $FPATH and 
shared directories in SPATH to find it 

-x obsolete; no effect; export the function 


across shell programs invoked by name 
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_______ BUILT-IN COMMANDS (continued) —___, 


typeset [+AEFHilLnprRtuxZ([n]] [name[=value]] 
set attributes and values of variables; 
inside functions, create new copies of the 
variables; using + instead of — turns attributes off; 
with no names or attributes, print every 
variable’s name and attributes 
-A name is an associative array 
-E name is a floating point number; n is 
number of significant figures 
use %g to expand 
-F name is a floating point number; n is 
number of decimal places 
use %f to expand 


-H UNIX to host file name mapping on 
non-UNIX systems 

-i name is an integer; n is output base, 
otherwise set from first assignment 

-l convert all upper-case characters to 
lower case; turn off -u 

-L left justify; n is width, or set from 
first assignment; turn off -R 

—n name is a nameref variable 

-p print typeset commands to recreate 
vanables with same attributes 

-r mark names readonly 

-R right justify; n is width, or set from 
first assignment; turn off —L 

-t tag the variables 

-u convert all lower-case characters to 
upper case; turn off -1 

-x mark names for export 

-Z right justify, fill with leading zeros; n is 


width, or set from first assignment 
wlimit [type] [options] [limit] 
set or print per-process limits 
type (default is both): 
-H hard limit 
-S soft limit 


options: 
-a all (display only) 
-c core file size 
-d “k" of data segment 
-f maximum file size 
-m “k” of physical memory 
-n maximum file descriptors +1 
-p size of pipe buffers 
-s “k" of stack segment 
-t cpu seconds 
-v “k" of virtual memory 


-f assumed if no options given 
sizes for -c, -s, and —p are all in 512-byte blocks 
the new limit can be an arithmetic expression 
jumask [-S] [mask] 
set file creation permissions mask to complement of 
mask if octal, or symbolic value as in 
chmod 
with no arguments, prints current mask 
octal mask is permissions to remove 
-S print current mask in symbolic form 
symbolic mask is permissions to keep 
unalias [—a] names 
remove aliases names 
-a remove all aliases 


_______ BUILT-IN COMMANDS (continued) —__ 


unset [—fnv] [names] 
unset variables names (same as —v) 


-f unset functions names 
—n unset nameref, not referenced variable 
-v unset variables names 


unsetting LINENO, MAILCHECK, OPTARG, 
OPTIND, RANDOM, SECONDS, TMOUT, 
and _, removes their special meaning 
even if used afterwards 
wait [jobid...] 
wait for job jobid; if no job, wait for all children 
whence [~afpv] name ... 
indicate how each name is treated by the shell 


-a print all interpretations of name 

-f skip the search for functions 

-p do a path search even if name is a 
keyword, alias, or function 

-v produce verbose information 


__________ OPTIONS TO test 

The test command, and its synonym [...], are built-in to 
ksh. The command accepts all of the options listed in 
the Conditional Expressions section. However, since it is 
a command, options and arguments must be quoted to 
get proper behavior, and normal pattern expansion and 
field splitting are done. Parentheses used for grouping 
must be quoted. test complies with POSIX for no more 
than three arguments. 


The -a and —-o options have the following meanings, 
instead of the ones listed in Conditional Expressions: 


-a logical AND 
-o logical OR 
The [[...]] compound command is preferred. 


OPTIONS TO set 
The set command is complicated. Here is a summary. 
Use + instead of — to turn options off. 
With no arguments, set prints the names and values 
of all variables. 


set [tabCefhkmnpstuvx] [+o option ...] [+A name] [arg...] 


-a automatically export variables upon 
assignment 

-A array assignment; +A does not clear 
the array first 

-b print job completion messages 
immediately, don't wait for next prompt 

-C same as —o noclobber 

-e upon non-zero exit from a command, 
execute the ERR trap, then exit 

-f disable pattern expansion 

-h automatically make each command a 
tracked alias 

-k place all variable assignments in 
the environment (obsolete) 

-m run background jobs in their own 


process group, print a message 

when they exit; set automatically for 

interactive shells on job control systems 
—n read commands without executing them 


(ignored if interactive) 
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OPTIONS TO set (continued) 


FUNCTIONS (continued) 


SIGNALS AND TRAPS (continued) ___ 


-o set options; with no arguments, pnnt 
current settings 
allexport same as —a 
bgnice run background jobs at 
lower priority 
emacs use an emacs-style line 
editor 
errexit same as -e 
gmacs use a gmacs-style line 
editor 
| ignoreeof forces use of exit 
keyword same as —k 
| markdirs append / to expanded 
| directory names 
} monitor same as -m 
noclobber force >| to overwnite 
for existing files 
noexec same as —n 
noglob same as —f£ 
| nolog don't save functions in 
history file 
notify same as —b 
| nounset same as -u 
privileged same as —p 
trackall same as —h 
| verbose same as -v 
| vi use a vi-style line editor 
viraw use with vi on systems 
| without a smart tty 
line discipline 
xtrace same as —x 
-p don't read SHOME/.profile and read 
| /etc/suid_profile instead of SENV file 
| -8 sort the positional parameters 
| -t read and execute one command, 
then exit (obsolete) 
H -u make it an error to substitute an unset 
| variable 
-v print input lines as they're read 
-x print commands as they're executed 


output is quoted for later reuse 

- turn off -v, —x, stop looking for flags 
(obsolete) 

-- do not change flags; set positional 
parameters from argument list 


FUNCTIONS 


Functions min in the same process as the calling script, 
and share the open files and current directory. They 
access their parameters like a script does, via $1, $2, 
and so on. return can only be used inside a function. 
Functions with ksh semantics may be recursive, and 
have local variables (declared using typeset). Such 
functions have their own set of traps. Those that are 
not caught or ignored terminate the function and are 
passed on to the calling shell program. $0 is set to the 
name of the function. 


ksh93 gives ksh semantics to functions declared with 
function, and POSIX semantics to functions declared 
with name(). Such functions share traps and variables 
with the “parent” script, and may not be recursive. If 
the . command is used on a function function, then 
POSIX semantics apply to that invocation. 


All versions of ksh88 give ksh semantics to functions 
declared with the function keyword, and to functions 
declared with the System V name () syntax. 


Functions may be declared as undefined, using typeset 
-fu. The first time such a function is invoked, ksh will 
do a path search. Ifa file with the name of the function 
is found in $PATH, and the directory is also in SFPATH 
(only in $FPATH), ksh will expect to load the definition 
of the function from that file, and will execute anything 
else in the file. ksh will then run the function. 


Functions may be exported across shell scripts that do 
not cause a separate invocation of ksh by using typeset 
-fx (This does not put shell functions into the 
environment.) 


DISCIPLINE FUNCTIONS (ksh93 only) 
For any variable var, you can define functions var.get, 
var.set, and var.umset. These are called discipline 
functions; they are called when operations are 
performed on the corresponding variable var. 


var.get called when var is accessed 
var.set called when var is assigned 
var.unset called when var is unset 


The variable ${.sh.name} contains the name of the 
variable for which the discipline function was called. 
S{.sh.subscript} is the subscript of the variable, and 
inside the set and get discipline functions, ${.sh.value} 
is the value being assigned or returned. Changing it in 
the function changes what will be used for the value. 
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RESTRICTED ksh 


If ksh is invoked as rksh, or rsh, or with the —-r option, it 
is restricted. The following actions are not allowed in a 
restricted shell: 


changing directory with cd 

setting or unsetting any of SSHELL, SENV, or SPATH 
using path names for commands that contain / 
redirecting output with any of >, >I, <>, or >> 

adding built-in commands 


These restrictions are in effect after the .profile and 
SENV files are read, allowing the author of the .profile 
full control in setting up the restricted environment. (In 
practice, restricted shells are not used much, as they 
are difficult to set up correctly.) 


Backgrounded commands (those followed by &) will 
ignore the SIGINT and SIGQUIT signals if the monitor 
option is turned off. Otherwise, they inherit the values 
of the parent ksh. 


_______ JOB IDS AND JOB CONTROL____ 


Jobs can be represented as follows: 


jobid the job identifier for a job, where: 
HN current job 
%+ current job 
%- previous job 
%?str job uniquely identified by str 
%n job number n 
Ypref job whose command line begins 
with pref 


Commands that take a jobid use the current job if no 
jobid is supplied 


Whenever a job completes, any trap on CHLD will be 
executed 


The commands fg and bg are only available on systems 
that support job control. This includes Linux, UNIX 
systems originally derived from Berkeley UNIX, System 
V Release 4 systems, and any System V Release 2 or 
Release 3 systems where the vendor has added job 
control. 


SIGNALS AND TRAPS 

Signal handling is done with the trap built-in command. 
The word argument describing code to execute upon 
receipt of the signal is scanned twice by ksh; once 
when the trap command is executed, and again when 
the signal is caught. Therefore it is best to use single 
quotes for the trap command. Traps are executed in 
order of signal number. You cannot change the status 
of a signal that was ignored when the shell started up. 


Traps on DEBUG happen before (after) commands are 
executed, Traps on 0 or EXIT inside a function-style 
(any) function happen right before the function returns. 


: SPECIAL CHARACTERS 
# start of comment; terminated by newline 
| pipe — connects two commands 
1& start co-process in background 
: command separator 
& run process in background; default stdin 
from /dev/null 
&& only run following command if previous 


command completed successfully 

I only run following command if previous 
command failed 

enclose string to be taken literally 

sd enclose string to have variable, command 
and arithmetic substitution only 


$() in-line command execution (new style) 
a in-line command execution (old style) 
((...)) arithmetic evaluation, like let "..." 
S((...)) in-line arithmetic evaluation 

\ treat following character literally 
\newline line continuation 


a 


COMMAND LINE EDITING 
To use the vi editor, use set -o vi, or set SVISUAL or 
SEDITOR to a value ending in vi. Use set -o viraw if 
your tty driver does not have “crt” features. 


To use the emacs editor, use set -o emacs, set -o 
gmacs, or set SVISUAL or SEDITOR to a value ending 
in emacs or gmacs. 


Both modes. provide filename and command 
completion. The emacs editor only works on history 
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lines, while the vi editor works on history commands. 
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VI EDITING MODE 


The vi editor has two “modes”, insert mode, and 
command mode. You start out in insert mode;| 
everything you type is part of the command line. To 
enter command mode, press the ESCAPE key. When 
you are finished entering a command, press the 
RETURN key to run the command and go back into 
insert mode. You may edit multi-line commands in vi 


mode. | 
Preceding a vi command with a number indicates how} 
many times the command should be repeated. 


Input Editing Commands 


(SG terminate insert mode (begin command mode) 
(CR (carriage return or line-feed) run command(s) 
(ERASE (the erase character set with stty) delete 
the previous character | 
alm (the kill character set with stty) delete | 
the whole line 
(NTR (the intr character set with stty) ignore 
what's been typed, start over 
“WwW delete the previous blank-separated word 
D end-of-file, terminate the session 
Vv escape the next character | 
\ escape the next character 


History Search Commands 


[n)k get previous command; successive k's keep 
going backward (older commands) 

[nJ- same as k 

(n]j get next command; successive j's keep 
going forward (newer commands) 

(n]+ same asj 

[n]G get command number n 


/string search backward (older commands) for string 
use “string to match string at the beginning 


of a line 
?string like /, but search forward (newer commands) 
n find next match of last / or ? pattern 
N like n, but in the opposite direction 
Text Modification Commands 
a enter input mode, appending after 
current character 
A enter input mode at end of line, same as $a 
[n]cmotion 
c[n]motion 


delete from current character through 
character that motion moves to, and enter 
input mode; if motion is c, delete the whole 
line and enter input mode 


Cc change from current character through 
end of the line; same as c$ 

({n)s replace characters under the cursor in 
input mode 

Ss same as cc (change the whole line) 

(n]dmotion 

d[n]motion 


delete from current character through 
character that motion moves to; 
if motion is d, delete the whole line 


Vi EDITING MODE (continued) —__ 


Text Modification Commands (continued) 


[nJp append previous text change after 
current character 

[n]P insert previous text change before 
current character 

[n]re replace n characters with c 

R enter overlay mode, replacing characters until 
pressing [SG 

[n]x delete current character 

{n)]xX delete previous character 

[n]. repeat last command 

[al invert the case of n characters 

[n]_ insert nth word of previous shell command 


and enter insert mode; use the last word if 
no n (not in real vi) 

3 append * to current word and do filename 
expansion, replacing current word with 
matching filenames, then enter insert mode 

\ replace current word with longest 
unique prefix of matching filenames; 
if unique, append / if directory, otherwise 
append a space, and enter insert mode 


Motion Commands 


njl forward one character 

n]w forward one alpha-numeric word 
njw move to next word after blank 

nje move to end of word 

njE move to end of blank delimited word 
njh backward one character 

njb backward one word 

(n]B backward one blank delimited word 
njl move to column n 


njfic find next c 

n)]Fc find previous c 

[nJtc like f followed by h 

n)Tc like F followed by 1 

nj; do last f, F, t, or T, n times 

n), same as ; but in opposite direction 

0 move to start of line 

e move to first non-blank character of line 


$ move to end of line 

% find balancing (, ), {, }, [, or ] (ksh88c and later) 
Other Commands 

[n]ymotion 

yln]motion 


yank from current character through where 
motion would go to 


yy yank the whole line 
Y yank from current character through 
end of line; same as yS (differs from real vi) 
u undo last command 
U undo all editing done to the line 


[n]v put hist -e $(VISUAL:-S{EDITOR:-vi}} n 
(fe -e S{(VISUAL:-S{EDITOR:-vi}} n) 
into input and mun it (net effect is to run 
an editor on the current line and to execute 
the results when editing is finished) 

L print a line-feed and re-print current line 

= list files that would match current word if a * 
were to be appended; doesn’t modify line 

Vv display version of ksh 


VI EDITING MODE (continued) 


Other Commands (continued) 

# put a # at the front of the line and send it; 
used mainly to save a line in the history 
without executing it; if first character is #, 
remove it and any others that follow newlines 

@letter macro expansion; look for an alias named 
_letter and, if found, read the value as 
command mode input 


On first word, *, \, and = expand aliases, functions, and 
commands. 


D delete from current character through 
end of line; same as dS 
i enter input mode, inserting before 
current character 
I enter input mode at beginning of line (like oi) | 
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EMACS EDITING MODE 

In emacs mode, every regular character you type is 
inserted into the input line. You use control characters 
and meta-characters (characters preceded by the 
ESCAPE key) to move the cursor or perform editing 
operations. Control keys are preceded by a’, thus “G is 
CONTROL-G. Meta-characters are preceded by M-, e.g. 
M-G means you press ESCAPE and then the G. Case 
matters only for meta-characters. You can have meta- 
control characters. 


The emacs editor keeps a mark, which is a saved 
position on the line. Many operations work relative to 
the current position and the mark. 


Numeric parameters indicate how many times to repeat 
the command. To enter a numeric parameter, type 
ESCAPE, the number, and then the command character. 
Commands marked with * don't take a numeric 


parameter. 

Cursor Motion Commands 

¥F forward one character 

M-f forward one word 

“B backward one character 
M-b backward one word 

“A move to start of line * 

E move to end of line * 

alle) forward to c on current line 


M-Jc backward to c on current line 


Character Deletion Commands 
(ERASE (the erase character set with stty) delete 
the previous character 


D delete current character 

M-d delete current word 

M-H (Meta-backspace) delete previous word 

M-h delete previous word 

M-? (Meta-DEL) delete previous word (won't work 
if your intr character is DEL) 

“WwW delete from cursor to mark 


Line Change Commands 
er: in emacs mode, transpose the current and 
revious characters and advance the cursor 
transpose current and next characters); in 
gmacs mode, transpose the two 
previous characters 


“Cc capitalize current character 

M-c capitalize current word 

M-1 lower-case current word 

K delete from cursor to end of line; if numeric 


parameter, it and cursor position specify start 
and end characters to delete 


Marking, Yanking, and Putting 
None of these commands take a numeric parameter 


xX interchange cursor and mark 
M-p save from cursor to mark in the yank buffer 
(KitQ (the stty kill character) delete the whole 


line; two in a row toggles “always print a 
line feed" mode for successive kills 


BY; yank last deleted item and put it back in line 
L line feed and redraw current line 

“@ set the mark 

M-space 


(meta-space) set the mark 


Running A Command 
CA (carriage return or line-feed) run command 
(EO (the eof character set with stty) treat 

as end-of-file if the current line is empty 


History Search Commands 


“Pp get previous history line 
N get next history line 

M-< get oldest history line * 
M-> get youngest history line * 


“Rstring search for string in history 
non-empty string and no parameter searches 
backwards 
non-empty string and parameter of 0 searches 
forwards 
no string and parameter of 0 searches in 
opposite direction 
no string and no parameter finds next 
occurrence of previous string 
if string begins with *, then searches for 
match at beginning of history line 
me) execute current line and fetch next 
history line * 


Miscellaneous Commands 

M-letter macro expansion; search alias list for 
_letter and read its value as input 

M-[letter macro expansion; search alias list for 
__/letter and read its value as input 

M-. insert last word of last command on line; 
if parameter, insert nth word of previous line 

M-_ like M-. 

M-* append * to current word and do filename 
expansion, replacing current word with 
matching filenames 

M-(sq replace current word with longest unique 
prefix of matching filenames; if unique, 
append / if directory, otherwise 
append a space and enter insert mode 

M-= list files that would match current word if a * 
were to be appended; does not insert 
anything into the line 

M-# put a # at the front of the line and send it; 
used mainly to save a line in the history 
without executing it; if first character is #, 
remove it and any others that follow newlines 


U multiply parameter of next command by four 
\ escape next character 
Vv display version of ksh 


On first word, M-*, M-sq, and M-= expand aliases, 
functions, and commands. 
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EMACS EDITING MODE (continued) ____ 
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